home *** CD-ROM | disk | FTP | other *** search
/ Computer Inter@ctive 16 / Computer Interactive cdrom 16 - dic 98.iso / zdnetit / content / WHANEW.ZIP / WHATSNEW.DOC < prev    next >
Encoding:
Text File  |  1996-10-02  |  11.1 KB  |  234 lines
  1.  
  2.                               What's New? V1.2
  3.  
  4.                               by John Augustine
  5.  
  6.   WN (What's New) was written in Assembly for MS Dos systems.
  7.   Requires Color Graphics (CGA) or better. Does not need a lot of memory.
  8.  
  9.   WN is VERY SIMPLE to use.  No Install procedures are required.  Does NOT
  10. Modify Any of Your files anywhere (I HATE when Programs do that).  You pick
  11. the Directory you want to keep WN in, and simply copy WN to that Directory.
  12.  
  13. NOTE: Information about V1.2 improvements is near the End of this Document.
  14.  
  15.   The purpose of WN is to Report all New Paths and their Files and all New
  16. Files in Old Paths.  WN also reports Files that Changed (in Old Paths of
  17. course).  For example, did you ever do an "Install" (Program/Application) and
  18. you wanted to know all that was Created (New Paths and/or Files), Installed
  19. (Files from a Source eg. CD Rom, Floppy, or Package), or Changed Files
  20. (Modified System, Drivers, or Parameter Files)?  This was my main reason for
  21. making WN.  Of course, you can also use WN to see what has been Added, or
  22. Changed over time.
  23.  
  24.   IMPORTANT NOTE:
  25.  
  26.   "New Files" in this Document will mean New Additions since you can add an
  27. Old file (old Date) to your HD (Hard Drive).
  28.  
  29.   The first thing you need is a Reference File of all that is in your HD.  I
  30. have included a file called, "MAKE_LST.BAT".  It will Create a file,
  31. "DIR_FILS.LST" using Dos's Directory Search Command.  I don't know what Dos
  32. version added the Directory Search Function.  I have Dos V6.  If you have an
  33. old version of Dos that doesn't have the Directory Search Function, you can't
  34. use WN.
  35.  
  36.   GETTING STARTED:
  37.  
  38.   (Also see below, TESTING WN without adding Files or Paths to your HD)
  39.  
  40.   I am going to use an "Install" operation as an EXAMPLE for using WN.  Many
  41. Programs/Applications require "Installation" before they can be used.
  42.  
  43.   Run "MAKE_LST.BAT" from any Directory.  When finished, you will be in the
  44. Root Directory, and the File "DIR_FILS.LST" will be there too.  Copy
  45. "DIR_FILS.LST" to the Directory where you have WN.
  46.  
  47.   Go to that Directory and Type WN and press Enter
  48.  
  49.   Press C from Main Menu to Create a Reference File and follow the Prompts.
  50. Note: WN will Delete (in the Directory where you have WN) "DIR_FILS.LST" after
  51. "WN.REF" is Created, since this "DIR_FILS.LST" is no longer needed.  WN V1.2
  52. now Copies the Time and Date Stamp from the "DIR_FILS.LST" File to the
  53. relative (Stripped Down) .REF File.
  54.  
  55.   Exit WN
  56.  
  57.   Now do the "Install" procedure (for your New Program/Application).
  58.  
  59.   When you are all done, go to the Directory where you have "MAKE_LST.BAT" and
  60. run that again.  Again Copy "DIR_FILS.LST" to the Directory where you have WN.
  61. Note: "MAKE_LST.BAT" first Renames "DIR_FILS.LST" in the Root Directory (if it
  62. exists there) before Creating a New one.  Run WN again, this time press, W
  63. (What's New) at the main menu and follow the Prompts.
  64.  
  65.   TIP:
  66.  
  67.   When the Report Pauses for a key press, "Press C to Continue...." or "Press
  68. Space Bar for Report" (Totals Report), turn on your Printer and press the
  69. Print Screen Key to get a Hardcopy, then press the C key, or the Space Bar.
  70.  
  71.   TESTING (Evaluating) WN without Adding Files or Paths to your HD:
  72.  
  73.   After you Create "WN.REF", Copy "DIR_FILS.LST" again from your Root Dir to
  74. the Directory where you keep WN.  Note: "DIR_FILS.LST" was Deleted (in the
  75. Directory where you keep WN) by WN after "WN.REF" was Created.
  76.  
  77.   NOTE: WN.REF is actually a Stripped Down Space saving "DIR_FILS.LST" which
  78. will have Exactly the same Time and Date (WN 1.2 improvement).
  79.  
  80.   Simply Edit (using a Text Editor) "WN.REF" by removing Lines with File Names
  81. and Lines with Path Names (Directory of C:\...).  See below for a sample of a
  82. List.  Make notes ("Log") of which ones you removed (for your reference).
  83. This has the effect of Adding Files and Paths to your HD, since they (the ones
  84. you removed) won't be in "WN.REF", but will be in "DIR_FILS.LST".  This
  85. Simulates New Files and/or Paths added to your HD because New Files and/or
  86. Paths Added to your HD, after the Reference File was made, won't be in the
  87. Reference File List.  When you make a New list, those New Files and/or Paths
  88. will be in the New List.  A simple way of putting it, what's in the New List
  89. and Not in the Old List (Reference File) is considered "New".  While you are
  90. still editing, change the Date or Time of a few Files to simulate Changed
  91. Files.  Don't forget to "Log" those file names for your reference.  Now run WN
  92. and see what happens.  Compare the Report to your "Log".  IMPORTANT NOTE: If
  93. you change a Path name (instead of removing it (Editing)), make sure it is in
  94. Alphabetical order, which is the order that the Dos Directory Search occurs.
  95. No harm will be done, but the Report will Not be correct if you change the
  96. Name of a Path (Directory of C:\....), and it isn't in Alphabetical order.  WN
  97. uses the Alphabetical order, in part, to determine if a Path is New or Not.
  98.   Note: If you REMOVE Lines with File names and/or Path names from
  99. "DIR_FILS.LST" (instead of "WN_REF") to simulate Files and/or Paths removed
  100. from your HD after the Reference ("WN.REF") file was Created, they won't be
  101. reported since WN reports New Additions, NOT Removals.
  102.  
  103.   More TIPS:
  104.  
  105.   WN reporting what Files and/or Paths have been REMOVED from your HD:
  106.  
  107.   Since "DIR_FILS.LST" is normally the Later (Newer) List (Files and Paths),
  108. and "WN.REF" is the older List, simply rename each File to trade places.
  109. Although "WN.REF" is a stripped down "DIR_FILS.LST", WN evaluates each line,
  110. and skips unimportant lines.
  111.  
  112.   You can have several "WN.REF" Reference files collected over time, each with
  113. a unique file name (example "WN2.REF", "WN3.REF", etc.), and you can compare
  114. between any two to see what the differences (New Additions) have been made.
  115. With WN V1.2, you don't have to Rename those .Ref files anymore before
  116. Comparing between any two WNX.REF Files.
  117.  
  118.   General Information about WN:
  119.  
  120.   WN is actually a sophisticated Text Files Comparer, custom designed for the
  121. Directories and Files Listing Created by Dos's Directory Search Function.  You
  122. will never get the same results with any general purpose Files Comparer.
  123.  
  124.   "WN.REF" and "DIR_FILS.LST" are Lists of all Directories and Files
  125. (including Hidden) in your HD.  "WN.REF" is just a Stripped down (unimportant
  126. Lines removed) version of "DIR_FILS.LST".  It usually (but not necessary)
  127. represents the Older List.  I could have had WN simply rename "DIR_FILS.LST"
  128. to "WN.REF" and the results would be exactly the same, but the Stripped down
  129. version is a little faster and uses less disk space for storage.  If you
  130. accumulate many reference files, the space savings adds up.
  131.  
  132.   WN compares contents of the "older list" WN.REF to a newer "DIR_FILS.LST"
  133. or Newer WNX.REF (X represents a Number) and Reports all the Files and Paths
  134. that are in the Newer File, but not in the Older File.  In other words, what's
  135. in the New list and not in the Older list is considered "New".
  136.  
  137.   WN detects a File Change by comparing the File Length (Bytes), Time, and
  138. Date of a File in the Reference file with it's duplicate (in the same Path) in
  139. the "DIR_FILS.LST" or Newer WNX.REF File.
  140.  
  141.   NOTE:
  142.  
  143.   Before WN, I made a Program called "FILES VALIDATOR  V1.3" (Uploaded on BBSs
  144. as "F_VALID3.ZIP" for the purpose of detecting Corrupted files or Virus
  145. "Infected" Files.  FV reported any file that changed, but does not use the
  146. Directory's Byte, Time, and Date Record.  FV Reads in every File completely,
  147. composing a "Signature" and Byte Count of every file, and comparing those
  148. Signatures and Byte Counts to those in a Reference File.  This is a different
  149. process than WN's method for detecting Changes in a file.
  150.  
  151.   For your reference, here is a small sample of the List which WN uses as a
  152. Base to Create "WN.REF".  The position of certain "Key" (I put an * at
  153. position or below position) characters in each Line is Critical.
  154.  
  155.   Partial "DIR_FILS.LST" Created using Dos Directory Search Function (Via
  156. "MAKE_LST.BAT"):
  157.  
  158.  (There are Only two types of Lines that are Important, others are ignored.)
  159.  
  160.  Volume in drive C has no label
  161.  Volume Serial Number is ####-####
  162.  
  163. Directory of C:\    (This is the Name of a Path therefore it is Important)
  164.  *           *
  165. IO       SYS        40,566 09-30-93   6:20a (This is Filename, also Important)
  166. MSDOS    SYS        38,138 09-30-93   6:20a       ''
  167. COMMAND  COM        54,619 09-30-93   6:20a       ''
  168. DOS          <DIR>  (Unimportant, Ignored (Directory of C:\DOS further Down))
  169. CPQDOS       <DIR>         03-16-95   6:55p (Unimportant)
  170. WINDOWS      *DIR>         03-16-95   6:55p       ''
  171. 999A20   386         9,349 09-30-93   6:20a
  172. CONFIG   SYS           396 03-16-95   7:59p
  173. ENCARTA      <DIR>         03-16-95   7:38p
  174. GAMES        <DIR>         09-19-95   8:15a
  175. TEMP         <DIR>         09-19-95   8:14a
  176. EDITORS      <DIR>         09-19-95   8:38a
  177. ASSEMBLY     <DIR>         09-19-95   8:40a
  178. MISC         <DIR>         09-19-95   8:53a
  179. UTYS         <DIR>         09-20-95   6:59p
  180.  
  181. Directory of C:\ASM   (Name of a Path, Important Line)
  182.  *           *
  183. .            <DIR>         11-12-95   5:43a
  184. ..           *DIR>         11-12-95   5:43a
  185. ASSY     BAT           209 01-18-96   7:02p
  186. MASM     EXE       110,703 02-01-88   1:00p
  187. LINK     EXE        65,475 02-01-88   1:00p
  188. ASM      BAT            19 02-20-96   8:55a
  189. EXE2COM  COM           432 11-16-95   2:17p
  190. WN       ASM        53,477 07-04-96   4:12p
  191.       223 file(s)     11,390,804 bytes
  192.  
  193. Total files listed:
  194.  *  5,926 file(s)    270,639,347 bytes
  195.                      375,062,528 bytes free
  196.  
  197. V1.2 IMPROVEMENTS:
  198.  
  199. 1.  When you Create a Reference (Stripped down "Dir_Fils.Lst"), the Time and
  200. Date Stamp of the .LST file will be Copied to the Created .REF File.  This
  201. fixes a problem if you Create a "Dir_Fils.LST" (via MAKE_LST.BAT) and days
  202. later you Create it's Stripped down version Reference file.
  203.  
  204. 2.  Now you can enter the Reference file name with Optional number (example
  205. WN1.REF, WN2.REF, WN3.REF, etc.) when you Create a Reference File.  Comparing
  206. (Whats_New) between any two .REF Files within a group of .REF files that you
  207. have collected is easy.  No longer do you have to Rename Files, before
  208. Comparing.
  209.  
  210. 3.  You can Skip making .REF Files if you don't mind using up more Space.  You
  211. can Rename the DIR_FILS.LST to whatever you desire, but remember, to Strip
  212. Down ("Create a Reference File") a File, you must Rename it back to
  213. "DIR_FILS.LST".
  214.  
  215. 4.  The "MAKE_LST.BAT" file has been improved too.  If a "DIR_FILS.LST"
  216. already exist in the Root Directory, it will be renamed to "DIR_FILS.BAK".
  217.  
  218.   CONCLUSION:
  219.  
  220.    You are not expected to pay for this program.  A small donation for all my
  221. work will be GREATLY APPRECIATED.  Complaints or Compliments are always
  222. welcomed. If you have a complaint regarding WN's operation, please give
  223. details.
  224.  
  225.    If you have any questions, don't feel obligated to make a donation in order
  226. to get an answer.  Just send your question/s along with a S.A.S.E.
  227.  
  228.  
  229.                             John Augustine N3AOF
  230.                             3129 Earl St.
  231.                             Laureldale, Pa 19605
  232.                             (610) 929-8850
  233.  
  234.